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Preface 


This program directory contains information concerning the maternal and procedures 
associated with the installation of VS Pascal Compiler and Library Release 2 (also 
referred to in this program directory as VS Pascal). This program directory should 
be reviewed in its entirety prior to the installation of VS Pascal, and used in con- 
junction with VS Pascal Installation and Customization for VM, and should be 
retained for future reference. 


VS Pascal Compiler and Library is an IBM licensed program for use in developing 
business-oriented applications. 


In this program directory, any reference made to IBM licensed programs is not 


intended to state or imply that only IBM’s licensed programs may be used; any 
equivalent program conforming to IBM published interfaces may be used. 
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= 1.0 Introduction 


The program directory describes the VS Pascal licensed program shipped with this 
document. It is intended for the system programmer responsible for program instal- 
lation and maintenance. 


Basic materials and documentation are identified. 


Installation requirements and procedures specific to installing this licensed program 
in a CMS environment are described. 


Warning: If you have Pascal/VS (Program Number 5796-PNQ) and/or VS Pascal 
Release | installed on your system, ensure. your production minidisk for VS Pascal 
Release 2 1s different from that of Pascal/VS and/or VS Pascal Release | as there 
will be naming conflicts. 
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2.0 Program Materials 


2.1 Basic Machine-Readable Material 


The distribution medium for VS Pascal Compiler and Library is a standard-labeled 
9-track tape written at either 1600 BPI or 6250 BPI, or 3480 cartridge. 


Table 1. Basic Machine-Readable Material 


Feature 
Track/Density | Number | External Tape Label 


9/1600 5870 | BASIC - CMS 
9/6250 5871 | BASIC - CMS 
3480 Cartridge | 5872 | BASIC - CMS 


There are five CMS VMFPLC2 dump files on the tape. They are as follows: 
File 1 Product identifier and installation EXEC 


File 2 Memo to users 


File 3 Compiler modules, run-time and debugging TXTLIBs; product 
LOADLIBs; MACLIBs; compile, link-edit and execute EXECs, EXEC 
HELP files; and product message files 


File 4 Installation verification EXEC and sample programs 


File 5 Files for-service and customization 


2.2 Optional Machine-Readable Material 


The distribution medium for VS Pascal Restricted Source Materials is a standard- 
labeled 9-track tape wnitten at either 1600 BPI or 6250 BPI, or 3480 cartndge. 


Table 2. Optional Machine-Readable Material Medium 


Feature ; 
Number External Tape Label 
7890 MVS/VM Optional Source 


7891 MVS/VM Optional Source 
7892 MVS/VM Optional Source 


There are four IEBUPDTE format files on the tape. They are as follows: 


Track/Density 
9/1600 


3480 Cartridge 


File 1 Copynght information 


File 2 Macros needed to assemble and compile the source modules 
File 3 Pascal source modules 
File 4 Assembler source modules 
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( 2.3 Program Publications 


<4 


2.3.1 Basic Program Publications 
One copy of the following documentation is included with this package. For addi- 
tional copies, contact your IBM representative. 
Unlicensed Documentation 
¢ VS Pascal Installation and Customization for VM, SC26-4342 
¢ VS Pascal Licensed Program Specification, GC26-4317 
¢ VS Pascal Language Reference, SC26-4320 
¢ VS Pascal Reference Summary, SX26-3760 
¢ VS Pascal Application Programming Guide, SC26-4319 


Licensed Documentation 


e VS Pascal Diagnosis Guide and Reference, LY 27-9525 


2.3.2 Optional Documentation 
The following publication is not shipped with this package, but is related to the 
installation of this product. This publication may be ordered by contacting your 
IBM representative. 


_—— ¢ VS Pascal General Information, GC26-4318 


2.4 Microfiche 


There is no microfiche for VS Pascal. 
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3.0 Program Support 


3.1 Program Services 


VS Pascal is classified as a licensed program (LP). Contact your IBM Marketing 
Representative for information concerning available program services. 


3.2 Preventive Service Planning (PSP) 


Before installing VS Pascal, use INFO/ACCESS or ask your IBM Support Center 
to check the Preventive Service Planning facility for the latest additional information 
available for this program. To obtain this information, specify: 


UPGRADE Subset 


PASCAL120 PASCAL/120 


3.3 Statement of Support Procedures 


Report any difficulties you have using this program to your IBM Support Center. 
If an Authorized Program Analysis Report (APAR) ts required, submit it to the 
location identified in the Programming System General Information Manual 
(PSGIM), G229-2228. 


The field engineering service number (FESN) for this product 1s: 


Table 3. FESNs and Component IDs 
Product Component ID FESN 


Compiler 566876701 6476701 
566871701 6471701 
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C 4.0 Program and Service Level Information 
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This section identifies the program and service level of VS Pascal. The program level 
refers to the APAR fixes which have been incorporated into the program. The 
service level refers to the PTFs which have been incorporated. 


4.1 Program Level Information 
The following APARs have been incorporated into VS Pascal Compiler and Library 


Release 2: 
PL12020 PL20071 PL27419 PL33935 
PL17420 PL20773 PL27652 PL33981 
PL17959 PL20777 PL29141 
PL18025 PL22514 PL29702 
PL 18687 PL23599 PL29897 
PL18688 PL26174 PL29899 


4.2 Service Level Information 
The following PTFs have been incorporated into VS Pascal Compiler and Library 


Release 2: 
ball UL25861 UL36467 UL36708 UL37819 
UL20983 UL39647 UL38764 UL39649 
UL23716 UL35206 UL34251 
UL39645 UL38764 UL34838 
UL26868 UL33613 UL38648 
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5.0 Installation Requirements and Considerations 


5.1 Programming Systems 


The following sections identify the resources, materials, prerequisite programs and 
service required to install and use VS Pascal. The information is categorized into 
two areas which describe distinct system environments: the system used to install the 
program (Installation System), and the system on which the program will be 
installed and used (Execution System). 


5.1.1. Installation System Requirements 
The following describes the environment of the installation system required to install 
VS Pascal. 


5.1.1.1 Operating System 
Installation of VS Pascal requires the following minimum system environment or 
subsequent releases: 


¢ VM/SP Version 1, Release 4 with or without HPO 


5.1.1.2 Hardware 
There are no special hardware requirements for installing VS Pascal. 


5.1.1.3 Software 


There are no special software requirements for installing VS Pascal. 


5.1.1.4 DASD Storage 
Production Minidisks 


The production minidisk contains the production libranes required to run VS 
Pascal. It must be linked and formatted pnior to installing VS Pascal. The fol- 
lowing table shows the estimated DASD space requirements for the production 
munidisk. 


Table 4. Production Disk Space Requirements 
Estimated DASD Space 
| Number of Cylinders of Cylinders sas 


Block 
Sr v0 | Bc 


Temporary .\Minidisk 
During customizing or servicing of VS Pascal, the installation EXEC will create a 


temporary disk. The following table shows the DASD space requirements for the 
temporary disk. 
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Table 5. Temporary Disk Space Requirements 


DASD Space Requirements 
| Number of Cylinders of | Number of Cylinders ee 


Bi k 
a 


Optional Restricted Source Minidisk 


The restricted source minidisk contains source modules and macros. It must be 
linked and formatted prior to installing the restricted source materials. The fol- 
lowing table shows the estimated DASD space requirements for the restricted source 
muinidisk. 


Table 6. Restricted Source Disk Space Requirements 
DASD Space Requirements 
} Number of Cylinders | of } Number of Cylinders | — 


B 
sie | a0 | ams | ao | ls 
rac es sm 


w 5.1.2 Execution System Requirements 


The following describes the environment of the execution system required for use of 
VS Pascal. 


5.1.2.1 Operating System 


5.1.2.2 Hardware 


5.1.2.3 Software 


Refer to 5.1.1.1, “Operating System” on page 6. 


Note: Use of VS Pascal’s Double-Byte Character Set (DBCS) support requires 
VM/SP Version 1, Release 5 or later. 


The VS Pascal Compiler and Library and its generated object programs run on 
those processors supported by the operating systems listed previously. It will 
support all devices in those operating systems which are transparent through the 
provided QSAM, BSAM, BPAM, and BDAM access methods. 


VS Pascal and its generated object programs will run in the VM/CMS operating 
system only with the OS simulation facility. 


5.1.2.4 DASD Storage 


Storage requirements for execution are reflected in the target library table as shown 
in 5.1.1.4, “‘DASD Storage” on page 6. 
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5.2 Special Considerations 


5.2.1 Programming Considerations 
If you have Pascal/VS (Program Number 5796-PNQ) and/or VS Pascal Release 1 
installed on your system, ensure your production muinidisk for VS Pascal Release 2 
is different from that of Pascal/VS and or VS Pascal Release | as there will be 
naming conflicts. 


5.2.2 Installation Guide Errata 
The following notes are provided in addition to, and as corrections to VS Pascal 
Installation and Customization for VM. In cases of conflicting information, the 
information in this Program Directory takes precedence. 


Page 7 Add the following note: 


Note: If you choose to install the Compiler above the 16-megabyte line, 
you have to modify the VSPASCAL EXEC as follows: 


- Add “GLOBAL LOADLIB PASRTLIB” after 
“GLOBAL TXTLIB AMPLANG”. 


Page 22 Add the following note to the end of the section: 


Note: If you choose to install the Compiler above the 16-megabyte line, 
you have to modify the VSPASCAL EXEC as follows: 


- Add GLOBAL LOADLIB PASRTLIB after 
“GLOBAL TXTLIB AMPLANG”. 
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Cc 6.0 Installation Instructions for Basic Machine-Readable 
‘ Material 


6.1 Program Code Installation 


The following figure is a sample install. User input is highlighted. Refer to VS 
Pascal Installation and Customization for VM for detailed installation instructions 
for the installation procedure and the additional prompts. 


vmplic2 load * * m 

LOADING.... 

15668767 012005 Ml 

15668767 EXEC 1 Ml 
END-OF-FILE OR END-OF-TAPE 
R; 


15668767 


Figure 1. Sample Install Job 


6.2 Installation Verification Procedure (IVP) Output 


The output from running the IVP is shown in Figure 2 on page 10. 
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*** VS Pascal Compiler and Library verification in progress. 


Invoking VS Pascal Release 2.0 
Starting Language Analysis Pass... 
Starting Optimization Pass... 
Starting Code Generation Pass... 


No Compiler Detected Errors 


Source lines: 


2 
31 
73 

127 
179 
233 
283 
353 
419 
467 


3 
37 
79 

131 
181 
239 
293 
359 
421 
479 


58; 
5 
41 
83 
137 
191 
241 
307 
367 
431 
487 


Total time: 

7 11 
43 47 
89 97 
139 149 
193 197 
251 257 
311 313 
373 379 
433 439 
491 499 


Invoking VS Pascal Release 2.0 
Starting Language Analysis Pass... 
Starting Optimization Pass... 
Starting Code Generation Pass... 


No Compiler Detected Errors 


Source lines: 


*** VS Pascal Compiler and Library verification successful. 


PPPPPPP 


III 
I] 
IT 
I] 
Il 
Il 
Il 

IIT] 


131; 


A 


Total 
AAAA 


A A 


A 
A 


AAAAAAAA 


S 


A 


SSSS 
S S 


SSSSS 
S 
S 
S S 
SSSS 


time: 
SSSS 
S 
S 
SSSSS 


SSSS 


Q.xx seconds; 


13 

93 
101 
151 
199 
263 
317 
383 
443 
503 


O.xx seconds; 


17 

99 
103 
157 
211 
269 
331 
389 
449 
509 


CCCCCC 


AYAaAAAAN 


C 
C 


C 
C 


CCCCCC 


...at 15:51:05 on 15/11/88 


Figure 2. VS Pascal Output During IVP 


Installation Instructions for Basic \lachine-Readable \Mlaterial 


Xxxxx LPM 


XXxXxx LPM 


Total rate: 
19 23 29 
61 67 71 
107 109 113 
163 167 173 
223 227 229 
271 277 281 
337 347 349 
397 401 409 
457 461 463 
521 523 541 
Total rate: 
AAAA L 
A AL 
A AL 
A AL 
AAAAAAAA L 
A AL 
A AL 
A A EEEBRE 
U U PPPPPPP 
U U P P 
U U Pp P 
U U PPPPPPP 
U U P 
U U P 
U UY -P 
YUUU P 
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C 7.0 Installation of Optional Restricted Source Materials 


? 


The VS Pascal optional restricted source materials is provided as machine-readable 


material on one magnetic tape. Each file on the tape consists of 80-character 
records blocked at 12,000 bytes. 


The source modules and macros may be loaded from the tape under CMS as 
follows: 
1. Mount the installation tape on an appropniate tape device. 


2. Use the CMS command TAPE to position the tape device at the desired tape 
file. 


3. Issue the following CMS command to load the source onto disk: 
TAPPDS * ft fm (COL1 UPDATE TAPn 


where ft and fm are the filetype and filemode of the source files, and TAPn is 
the symbolic name of the tape device. 


For example, if the tape is on device 182 and you are reading the second file 
(macros) onto your A-disk, the command would be: 


TAPPDS * COPY A (COL1 UPDATE TAP2 


Note: Refer to your VM documentation for a detailed explanation of the TAPE 
and TAPPDS commands. 
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VS Pascal 


Reader Comment Form 


To better enable us to meet your needs in future VS Pascal Compiler and Library program directories, please rate the 
following characteristics, entering a digit in the range one (for very poor or very low) to five (for very good or very 
high). 


Completeness 


—> 


Accuracy 


Clarity 


—~ 


Format 


Usefulness 


Please provide specific comments on problems you found with this program directory. Attach additional sheets as 
needed. 


After completing the evaluation, detach this page and send via first class mail to: 
IBM Corporation 
P. O. Box 49023 
San Jose, California 95161-9023 


Attention: Manager, VS Pascal Development, Vi43 D30 
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